ARexx-kommandon

Fönster- och överföringsrelaterade kommandon

CANCEL
CHANCLOSE
CHANDATA
CHANHEADER
CHANOPEN
CLOSE

RESETFRAME
SAVEAS
SCROLL
URLFIELD
WAIT
WINDOW

CANCEL

Mall:


   CANCEL ALL/S

Avbryter överföringarna för det här fönstret. Gör samma sak som knappen avbryt.

Argument Beskrivning
ALL Avbryter alla överföringar. Gör samma sak som knappen avbryt alla i nätverksstatusfönstret.

Argument	Beskrivning
ALL	Avbryter alla överföringar. Gör samma sak som knappen avbryt alla i nätverksstatusfönstret.

CHANCLOSE

Mall:


   CHANCLOSE CHANNEL/A

Stänger den här inkrementella indatakanalen. Om kanalen redan var stängd returneras 5 (i RC).

Argument Beskrivning
CHANNEL Kanal-id som returnerades av kommandot CHANOPEN.

Argument	Beskrivning
CHANNEL	Kanal-id som returnerades av kommandot CHANOPEN.

Se kommandot CHANOPEN för en kort beskrivning av inkrementella indatakanaler.

CHANDATA

Mall:


   CHANDATA CHANNEL/A,DATA/A,NL=NEWLINE/S

Skickar data till den här inkrementella indatakanalen. Om kanalen var stängd returneras 5 (i RC).

Argument Beskrivning
CHANNEL Kanal-id som returnerades av kommandot CHANOPEN.
DATA Sträng med data att skicka till kanalen.
NEWLINE Lägg till en radmatning efter datan.

Argument	Beskrivning
CHANNEL	Kanal-id som returnerades av kommandot CHANOPEN.
DATA	Sträng med data att skicka till kanalen.
NEWLINE	Lägg till en radmatning efter datan.

Se kommandot CHANOPEN för en kort beskrivning av inkrementella indatakanaler.

CHANHEADER

Mall:


   CHANHEADER CHANNEL/A,HEADER/A

Skickar ett HTTP-huvud till den här inkrementella indatakanalen. Om kanalen var stängd returneras 5 (i RC).

Alla huvuden bör skickas innan någon data skickas, annars är resultatet oförutsägbart.

Argument Beskrivning
CHANNEL Kanal-id som returnerades av kommandot CHANOPEN.
HEADER Ett HTTP-huvud, t.ex. "Content-Type: text/html".

Argument	Beskrivning
CHANNEL	Kanal-id som returnerades av kommandot CHANOPEN.
HEADER	Ett HTTP-huvud, t.ex. "`Content-Type: text/html`".

Se kommandot CHANOPEN för en kort beskrivning av inkrementella indatakanaler.

CHANOPEN

Mall:


   CHANOPEN URL/A

Öppnar en inkrementell indatakanal för denna URL.

ARexx-variabeln RESULT kommer att sättas till id:t för den öppnade kanalen.

Argument Beskrivning
URL URL som skall laddas via denna kanal.

Argument	Beskrivning
URL	URL som skall laddas via denna kanal.

Inkrementella indatakanaler kan användas för att generera och inkrementellt visa ett dokument, istället för att skriva data till en fil och sedan använda kommandot OPEN för att ladda hela filen på en gång.

I princip startas en laddningsprocess av det här kommandot, som använder ARexx-kommandona CHAN... för sin indata. Du kan ange den URL för vilken den här laddningsprocessen startas. Du kan ange vilken URL du vill, i vilket format du vill (men det rekommenderas att du följer det generella URL-formatet "protokoll:protokollspecifik-del"). URL:en visas inte automatiskt; du måste skicka ett OPEN-kommando efter det att du har öppnat kanalen. Använd inte RELOAD, eftersom det avbryter eventuella pågående överföringar för URL:en, och stänger därmed en kanal.

Använd kommandona CHANHEADER, CHANDATA och CHANCLOSE för att skicka data till kanalen. Observera att kanalen kan stängas av användaren (genom att avbryta laddningsprocessen). Dessa kommandon returnerar 5 (i RC) om kanalen var stängd.

Data som skickas via en kanal kommer att lagras i fickminnet (såvida inte URL:en är satt att inte lagras i fickminnet). Om datan inte skall lagras i fickminnet bör du skicka huvudet "Pragma: No-cache".

CLOSE

Mall:


   CLOSE FORCE/S

Stänger det adresserade fönstret.

Argument Beskrivning
FORCE Visa inte något bekräftelsefönster om det är det sista öppna läsarfönstret som skall stängas.

Argument	Beskrivning
FORCE	Visa inte något bekräftelsefönster om det är det sista öppna läsarfönstret som skall stängas.

FOCUS

Mall:


   FOCUS TARGET/K

Byter fokus för tangentbordsrullningen till den angivna ramen.

Argument Beskrivning
TARGET Målnamn för det fönster eller den ram som skall fokuseras. Om inget mål anges fokuseras huvudfönstret.

Argument	Beskrivning
TARGET	Målnamn för det fönster eller den ram som skall fokuseras. Om inget mål anges fokuseras huvudfönstret.

GO

Mall:


   GO N/N,BACK/S,FWD=FORWARD/S,HOME/S

Går genom fönsterhistorian.

Argument Beskrivning
N Ett tal som anger hur många steg som skall gås. Förvalt värde är 1.
BACK Gå bakåt genom fönsterhistorian.
FORWARD Gå framåt genom fönsterhistorian.
HOME Gå till hemdokumentet, om något är konfigurerat.

Argument	Beskrivning
N	Ett tal som anger hur många steg som skall gås. Förvalt värde är 1.
BACK	Gå bakåt genom fönsterhistorian.
FORWARD	Gå framåt genom fönsterhistorian.
HOME	Gå till hemdokumentet, om något är konfigurerat.

Endast en av BACK, FORWARD och HOME kan anges samtidigt.

LOAD

Mall:


   LOAD URL/A,RELOAD/S,SAVEAS/K,APPEND/S,SAVEREQ/S,NOICON/S,POST/K

Laddar en fil i bakgrunden eller sparar en fil som inte kan visas.

Argument Beskrivning
URL URL som skall hämtas i bakgrunden.
RELOAD URL:en kommer att hämtas igen även om den redan finns i fickminnet.
SAVEAS Om ett namn anges kommer filen att sparas under det namnet.
APPEND Sparas källkoden kommer den att läggas till den fil som anges i argumentet SAVEAS.
Om APPEND inte anges kommer filen som anges i SAVEAS att skrivas över.
SAVEREQ Öppna en filväljare för att låta användaren ange vilket namn filen skall sparas under.
NOICON I kombination med argumentet SAVEAS eller SAVEREQ gör det här argumentet att AWeb inte skapar någon ikon för den sparade filen.
POST Meddelande som skall postas. Om det här argumentet anges kommer dokumentet att hämtas med metoden POST i stället för GET.
Se kommandot OPEN för en kommentar angående POST-meddelanden.

Argument	Beskrivning
URL	URL som skall hämtas i bakgrunden.
RELOAD	URL:en kommer att hämtas igen även om den redan finns i fickminnet.
SAVEAS	Om ett namn anges kommer filen att sparas under det namnet.
APPEND	Sparas källkoden kommer den att läggas till den fil som anges i argumentet SAVEAS. Om APPEND inte anges kommer filen som anges i SAVEAS att skrivas över.
SAVEREQ	Öppna en filväljare för att låta användaren ange vilket namn filen skall sparas under.
NOICON	I kombination med argumentet SAVEAS eller SAVEREQ gör det här argumentet att AWeb inte skapar någon ikon för den sparade filen.
POST	Meddelande som skall postas. Om det här argumentet anges kommer dokumentet att hämtas med metoden POST i stället för GET. Se kommandot OPEN för en kommentar angående POST-meddelanden.

NEW

Mall:


   NEW URL/A,NAME/K,RELOAD/S,POST/K

Öppnar ett nytt fönster och laddar det angivna dokumentet i det nya fönstret.

ARexx-variabeln RESULT sätts till namnet på ARexx-porten för det nya fönstret.

Argument Beskrivning
URL URL som skall laddas och visas i det nya fönstret.
NAME Namn på det nya fönstret. Om det anges kan det nya fönstret adresseras från andra dokument genom att använda HTML-attributet TARGET.
RELOAD URL:en kommer att laddas igen även om den redan finns i fickminnet.
POST Meddelande som skall postas. Om det här argumentet anges kommer dokumentet att hämtas med metoden POST i stället för GET.
Se kommandot OPEN för en kommentar angående POST-meddelanden.

Argument	Beskrivning
URL	URL som skall laddas och visas i det nya fönstret.
NAME	Namn på det nya fönstret. Om det anges kan det nya fönstret adresseras från andra dokument genom att använda HTML-attributet `TARGET`.
RELOAD	URL:en kommer att laddas igen även om den redan finns i fickminnet.
POST	Meddelande som skall postas. Om det här argumentet anges kommer dokumentet att hämtas med metoden POST i stället för GET. Se kommandot OPEN för en kommentar angående POST-meddelanden.

OPEN

Mall:


   OPEN URL/A,TARGET/K,RELOAD/S,POST/K

Laddar det angivna dokumentet och visar det i det adresserade fönstret eller i den angivna ramen.

Argument Beskrivning
URL URL som skall laddas och visas.
TARGET Målnamn för fönstret eller ramen som det nya dokumentet skall visas i.
RELOAD URL:en kommer att laddas igen även om den redan finns i fickminnet.
POST Meddelande som skall postas. Om det här argumentet anges kommer dokumentet att hämtas med metoden POST i stället för GET.

Argument	Beskrivning
URL	URL som skall laddas och visas.
TARGET	Målnamn för fönstret eller ramen som det nya dokumentet skall visas i.
RELOAD	URL:en kommer att laddas igen även om den redan finns i fickminnet.
POST	Meddelande som skall postas. Om det här argumentet anges kommer dokumentet att hämtas med metoden POST i stället för GET.

En kommentar angående POST-meddelanden:

Meddelandet postas precis som det anges, så du måste ange det i "formulär-URL"-kodat format. Kortfattat betyder detta att:

Namn och värden i formulärfält måste separeras med =.
Olika formulärfältspar, namn=värde, måste separeras med &.
Alla mellanslag måste ersättas med +
Alla andra tecken som inte är siffror eller bokstäver i fältnamn och fältvärden måste ersättas med sekvensen %XX, där XX är den hexadecimala representationen av tecknet.

Du kan använda kommandot URLENCODE för att utföra de två sista kodningarna.

RELOAD

Mall:


   RELOAD TARGET/K,IMAGES/S

Laddar om dokumentet eller alla bilder i dokumentet i det adresserade fönstret eller den angivna ramen.

Argument Beskrivning
TARGET Målnamn för det fönster eller den ram som omladdningen skall begränsas till.
IMAGES Alla bilder i dokumentet laddas igen.
Om IMAGES inte anges laddas själva dokumentet igen.

Argument	Beskrivning
TARGET	Målnamn för det fönster eller den ram som omladdningen skall begränsas till.
IMAGES	Alla bilder i dokumentet laddas igen. Om IMAGES inte anges laddas själva dokumentet igen.

RESETFRAME

Mall:


   RESETFRAME TARGET/K

Återställer alla ramar i det adresserade fönstret eller den angivna ramen till deras ursprungliga storlekar. Observera att storleken på den adresserade ramen inte återställs.

Argument Beskrivning
TARGET Målnamn för det fönster eller den ram i vilken ramstorlekarna skall återställas.

Argument	Beskrivning
TARGET	Målnamn för det fönster eller den ram i vilken ramstorlekarna skall återställas.

SAVEAS

Mall:


   SAVEAS NAME,APPEND/S,TARGET/K,NOICON/S

Sparar HTML-koden för dokumentet i det adresserade fönstret eller den angivna ramen.

Argument Beskrivning
NAME Fil som HTML-koden skall sparas under.
Om NAME inte anges kommer en filväljare att öppnas.
APPEND Den sparade HTML-koden läggs till slutet på den fil som anges i argumentet NAME.
Om APPEND inte anges kommer den angivna filen att ersättas.
TARGET Målnamn för det fönster eller den ram som HTML-koden skall sparas för.
NOICON Skapa inte någon ikon för den sparade filen.

Argument	Beskrivning
NAME	Fil som HTML-koden skall sparas under. Om NAME inte anges kommer en filväljare att öppnas.
APPEND	Den sparade HTML-koden läggs till slutet på den fil som anges i argumentet NAME. Om APPEND inte anges kommer den angivna filen att ersättas.
TARGET	Målnamn för det fönster eller den ram som HTML-koden skall sparas för.
NOICON	Skapa inte någon ikon för den sparade filen.

SCROLL

Mall:


   SCROLL N/N,PAGE/S,FAR/S,UP/S,DOWN/S,LEFT/S,RIGHT/S,TARGET/K

Rullar innehållet i det adresserade fönstret eller den angivna ramen.

Argument Beskrivning
N Ett tal som anger antalet bildpunkter som skall rullas. Förvalt är 1.
PAGE Gör att argumentet N anger antal sidor istället för antal bildpunkter.
FAR Gör att innehållet rullas så långt som möjligt i den angivna riktningen.
UP Rullar den synliga delen mot början av dokumentet.
DOWN Rullar den synliga delen mot slutet av dokumentet.
LEFT Rullar den synliga delen mot den vänstra kanten av dokumentet.
RIGHT Rullar den synliga delen mot den högra kanten av dokumentet.
TARGET Målnamn för det fönster eller den ram som skall rullas.

Argument	Beskrivning
N	Ett tal som anger antalet bildpunkter som skall rullas. Förvalt är 1.
PAGE	Gör att argumentet N anger antal sidor istället för antal bildpunkter.
FAR	Gör att innehållet rullas så långt som möjligt i den angivna riktningen.
UP	Rullar den synliga delen mot början av dokumentet.
DOWN	Rullar den synliga delen mot slutet av dokumentet.
LEFT	Rullar den synliga delen mot den vänstra kanten av dokumentet.
RIGHT	Rullar den synliga delen mot den högra kanten av dokumentet.
TARGET	Målnamn för det fönster eller den ram som skall rullas.

Både UP och DOWN kan inte anges samtidigt; LEFT och RIGHT kan inte heller anges samtidigt. Minst en riktning måste anges.

URLFIELD

Mall:


   URLFIELD ACTIVATE/S,POS/K/N,SET/K

Aktivera URL-fältet i läsarfönstret eller ändra dess innehåll.

Argument Beskrivning
ACTIVATE Aktivera URL-fältet. Detta fungerar bara om fönstret också är aktivt.
Markören placeras efter det sista tecknet, såvida inte du anger en position med argumentet POS.
POS Anger en ny position för markören (det första tecknet har positionen 1).
SET En ny sträng att placera i URL-fältet.

Argument	Beskrivning
ACTIVATE	Aktivera URL-fältet. Detta fungerar bara om fönstret också är aktivt. Markören placeras efter det sista tecknet, såvida inte du anger en position med argumentet POS.
POS	Anger en ny position för markören (det första tecknet har positionen 1).
SET	En ny sträng att placera i URL-fältet.

WAIT

Mall:


   WAIT URL,DOC=DOCUMENT/S,IMG=IMAGES/S,ALL/S

Väntar på att de angivna överföringarna skall bli klara.

Argument Beskrivning
URL Kommandot kommer att vänta till dess överföringen för den här URL:en är klar. Om ingen överföring pågår för den här URL:en kommer kommandot att returnera omedelbart.
DOCUMENT Kommandot väntar bara på dokumentöverföringar. I det här läget betraktas allt som laddas direkt på den översta nivån i ett fönster eller i en ram som ett dokument, även om det är en bild eller en ljudfil.
IMAGES Kommandot väntar bara på bilder i dokumentet. I det här läget betraktas allt som laddas på grund av att det är infogat i dokumentet som en bild. Detta inkluderar bakgrundsljud.
ALL Kommandot väntar på alla överföringar i alla fönster.
Om det här argumentet inte anges kommer kommandot bara att vänta på överföringar i det adresserade fönstret och i ramar i detta fönster.

Argument	Beskrivning
URL	Kommandot kommer att vänta till dess överföringen för den här URL:en är klar. Om ingen överföring pågår för den här URL:en kommer kommandot att returnera omedelbart.
DOCUMENT	Kommandot väntar bara på dokumentöverföringar. I det här läget betraktas allt som laddas direkt på den översta nivån i ett fönster eller i en ram som ett dokument, även om det är en bild eller en ljudfil.
IMAGES	Kommandot väntar bara på bilder i dokumentet. I det här läget betraktas allt som laddas på grund av att det är infogat i dokumentet som en bild. Detta inkluderar bakgrundsljud.
ALL	Kommandot väntar på alla överföringar i alla fönster. Om det här argumentet inte anges kommer kommandot bara att vänta på överföringar i det adresserade fönstret och i ramar i detta fönster.

WINDOW

Mall:


   WINDOW RECT/K,ACTIVATE/S,TOFRONT/S,TOBACK/S,ZIP/S

Ändrar positionen och storleken på det adresserade fönstret.

Argument Beskrivning
RECT Rektangel som beskriver den nya positionen och storleken för fönstret.
ACTIVATE Aktiverar fönstret.
TOFRONT Flyttar fram fönstret framför alla andra fönster på skärmen.
TOBACK Flyttar bak fönstret bakom alla andra fönster på skärmen.
ZIP Växlar zoomläget på fönstret, som om användaren hade klickat på zoomningsknappen.

Argument	Beskrivning
RECT	Rektangel som beskriver den nya positionen och storleken för fönstret.
ACTIVATE	Aktiverar fönstret.
TOFRONT	Flyttar fram fönstret framför alla andra fönster på skärmen.
TOBACK	Flyttar bak fönstret bakom alla andra fönster på skärmen.
ZIP	Växlar zoomläget på fönstret, som om användaren hade klickat på zoomningsknappen.

Både TOFRONT och TOBACK kan inte anges samtidigt.